home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / c / recio202.zip / recio.h < prev    next >
C/C++ Source or Header  |  1994-05-05  |  9KB  |  232 lines
  1. /****************************************************************************
  2.    MODULE: recio.h
  3.   PURPOSE: record input/output header file included in application
  4. COPYRIGHT: (C) 1994 William Pierpoint
  5.   VERSION: 2.02
  6.   RELEASE: May 5, 1994
  7. *****************************************************************************/
  8.  
  9. #ifndef RECIO_H
  10. #define RECIO_H
  11.  
  12. typedef struct {
  13.         int      r_fd;       /* descriptor */
  14.         unsigned r_flags;    /* status flags */
  15.         FILE    *r_fp;       /* file pointer */
  16.   const char    *r_fname;    /* pointer to name of file */
  17.         long     r_recno;    /* current record number */
  18.         size_t   r_fldno;    /* current field number */
  19.         size_t   r_colno;    /* current column number in current record */
  20.         size_t   r_recsiz;   /* size of record buffer */
  21.         size_t   r_reclen;   /* current length of record buffer */
  22.         char    *r_recp;     /* pointer to record buffer */
  23.         size_t   r_fldsiz;   /* size of field buffer */
  24.         char    *r_fldp;     /* pointer to field buffer */
  25.         int      r_fldch;    /* field separator character */
  26.         int      r_txtch;    /* text delimiter character */
  27.         int      r_cxtno;    /* context number */
  28. } REC;
  29.  
  30. /* constant expression macros */
  31. #define RECBUFSIZ   80       /* minimum size of record buffer */
  32. #define FLDBUFSIZ   20       /* minimum size of field buffer */
  33. #define RECFLDCH   ' '       /* record field separator character */
  34. #define RECTXTCH   ' '       /* text delimiter character */
  35.  
  36. #define ROPEN_MAX    8       /* max no of rec streams open at same time */
  37. #define R_READ       0       /* read mode */
  38. #define R_WRITE      1       /* write/append mode */
  39.  
  40. #ifdef __BORLANDC__
  41. #define NSBUFSIZ    34       /* string buffer sized for ltoa & dtoa */
  42. #else
  43. #error set NSBUFSIZ for this compiler!
  44. #endif
  45. extern char _r_nsbuf[NSBUFSIZ]; /* numeric to string conversion buffer */
  46.  
  47. /* enumerate errors */
  48. enum {
  49.     R_EINVAL=1,              /* invalid argument value */
  50.     R_EINVDAT,               /* invalid data */
  51.     R_EINVMOD,               /* invalid read or write mode */
  52.     R_EMISDAT,               /* missing data */
  53.     R_ENOMEM,                /* could not allocate memory */
  54.     R_ENOPUT,                /* failed put to stream */
  55.     R_ERANGE                 /* data out of range */
  56. };
  57.  
  58. /* enumerate warnings */
  59. enum {
  60.     R_WEMPSTR=1,             /* data string empty */
  61.     R_WNOREG,                /* unable to register function (atexit full) */
  62.     R_WWIDTH                 /* column width too small for data */
  63. };
  64.  
  65. /* define static record streams */
  66. extern REC *recin;           /* recin  record pointer */
  67. extern REC *recout;          /* recout record pointer */
  68. extern REC *recerr;          /* recerr record pointer */
  69. extern REC *recprn;          /* recprn record pointer */
  70.  
  71. #define RECIN       -1       /* recin  context number */
  72. #define RECOUT      -2       /* recout context number */
  73. #define RECERR      -3       /* recerr context number */
  74. #define RECPRN      -4       /* recprn context number */
  75.  
  76. /* record status flags definitions */
  77. #define _R_COL       1       /* beginning column flag (bit 0) */
  78. #define _R_WRT       2       /* read/write stream flag (bit 1) */
  79. #define _R_EOF     128       /* end-of-file indicator (bit 7) */
  80. #define _R_ERR     256       /* error indicator (bits 8-11) */
  81. #define _R_WRN    4096       /* warning indicator (bits 12-15) */
  82.  
  83. #define _R_ERRMAX   15       /* maximum error number */
  84. #define _R_WRNMAX   15       /* maximum warning number */
  85.  
  86. /* functions implemented as macros */
  87. #define rskipfld(rp)     (rskipnfld((rp), 1))
  88. #define rnames(rp)       ((rp)->r_fname)
  89. #define rrecs(rp)        ((rp)->r_recp)
  90. #define rflds(rp)        ((rp)->r_fldp)
  91. #define rrecno(rp)       ((rp)->r_recno)
  92. #define rfldno(rp)       ((rp)->r_fldno)
  93. #define rcolno(rp)       ((rp)->r_colno + rbegcolno(rp))
  94. #define rcxtno(rp)       ((rp)->r_cxtno)
  95. #define rbegcolno(rp)    ((rp)->r_flags & _R_COL)
  96. #define reof(rp)         ((rp)->r_flags & _R_EOF)
  97.  
  98. #define rgeti(rp)        (rbgeti( (rp), 10))
  99. #define rgetl(rp)        (rbgetl( (rp), 10))
  100. #define rgetui(rp)       (rbgetui((rp), 10))
  101. #define rgetul(rp)       (rbgetul((rp), 10))
  102.  
  103. #define rcgeti(rp, begcol, endcol)  (rcbgeti( (rp), (begcol), (endcol), 10))
  104. #define rcgetl(rp, begcol, endcol)  (rcbgetl( (rp), (begcol), (endcol), 10))
  105. #define rcgetui(rp, begcol, endcol) (rcbgetui((rp), (begcol), (endcol), 10))
  106. #define rcgetul(rp, begcol, endcol) (rcbgetul((rp), (begcol), (endcol), 10))
  107.  
  108. #define rputi(rp, num)   (rbputi( (rp), 10, (num)))
  109. #define rputl(rp, num)   (rbputl( (rp), 10, (num)))
  110. #define rputui(rp, num)  (rbputui((rp), 10, (num)))
  111. #define rputul(rp, num)  (rbputul((rp), 10, (num)))
  112.  
  113. #define rcputi(rp, begcol, endcol, num)  (rcbputi( (rp), (begcol), (endcol), 10, (num)))
  114. #define rcputl(rp, begcol, endcol, num)  (rcbputl( (rp), (begcol), (endcol), 10, (num)))
  115. #define rcputui(rp, begcol, endcol, num) (rcbputui((rp), (begcol), (endcol), 10, (num)))
  116. #define rcputul(rp, begcol, endcol, num) (rcbputul((rp), (begcol), (endcol), 10, (num)))
  117.  
  118. #ifdef __cplusplus
  119. extern "C" {
  120. #endif
  121. /* function prototypes */
  122. /* source: recio.c */
  123. extern int   rclose(REC *rp);
  124. extern int   rcloseall(void);
  125. extern int   risvalid(REC *rp);
  126. extern REC  *ropen(const char *filename, const char *mode);
  127. extern int   rsetbegcolno(REC *rp, int colno);
  128. extern int   rsetcxtno(REC *rp, int cxtno);
  129. extern int   rsetfldch(REC *rp, int ch);
  130. extern int   rsettxtch(REC *rp, int ch);
  131.  
  132. /* source: rerr.c */
  133. extern void  rclearerr(REC *rp);
  134. extern int   rerror(REC *rp);
  135. extern char *rerrstr(REC *rp);
  136. extern int   rseterr(REC *rp, int errnum);
  137. extern void  rseterrfn(void(*rerrfn)(REC *rp));
  138. extern char *rstrerror(int errnum);
  139.  
  140. /* source: rwarn.c */
  141. extern void  rclearwarn(REC *rp);
  142. extern int   rwarning(REC *rp);
  143. extern char *rwarnstr(REC *rp);
  144. extern int   rsetwarn(REC *rp, int warnum);
  145. extern void  rsetwarnfn(void(*rwarnfn)(REC *rp));
  146. extern char *rstrwarning(int warnum);
  147.  
  148. /* source: rget.c */
  149. extern char *rgetrec(REC *rp);
  150. extern int   rsetfldsiz(REC *rp, size_t fldsize);
  151. extern int   rsetfldstr(REC *rp, char *s);
  152. extern int   rsetrecsiz(REC *rp, size_t recsize);
  153. extern int   rsetrecstr(REC *rp, char *s);
  154. extern int   rskipnfld(REC *rp, size_t num);
  155.  
  156. /* source: rput.c */
  157. extern int rputrec(REC *rp);
  158.  
  159. /* source: rgets.c */
  160. extern int    rgetc(REC *rp);
  161. extern char  *rgets(REC *rp);
  162.  
  163. /* source: rgetf.c */
  164. extern float  rgetf(REC *rp);
  165. extern double rgetd(REC *rp);
  166.  
  167. /* source: rbget.c */
  168. extern int           rbgeti( REC *rp, int base);
  169. extern unsigned int  rbgetui(REC *rp, int base);
  170. extern long          rbgetl( REC *rp, int base);
  171. extern unsigned long rbgetul(REC *rp, int base);
  172.  
  173. /* source: rcgets.c */
  174. extern int    rcgetc(REC *rp, size_t col);
  175. extern char  *rcgets(REC *rp, size_t begcol, size_t endcol);
  176.  
  177. /* source: rcgetf.c */
  178. extern float  rcgetf(REC *rp, size_t begcol, size_t endcol);
  179. extern double rcgetd(REC *rp, size_t begcol, size_t endcol);
  180.  
  181. /* source: rcbget.c */
  182. extern int           rcbgeti( REC *rp, size_t begcol, size_t endcol, int base);
  183. extern unsigned int  rcbgetui(REC *rp, size_t begcol, size_t endcol, int base);
  184. extern long          rcbgetl( REC *rp, size_t begcol, size_t endcol, int base);
  185. extern unsigned long rcbgetul(REC *rp, size_t begcol, size_t endcol, int base);
  186.  
  187. /* source: rputs.c */
  188. extern int rputc(REC *rp, int ch);
  189. extern int rputs(REC *rp, char *str);
  190.  
  191. /* source: rputf.c */
  192. extern int rputf(REC *rp, float f);
  193. extern int rputd(REC *rp, double d);
  194.  
  195. /* source: rbput.c */
  196. extern int rbputi(REC *rp, int base, int i);
  197. extern int rbputui(REC *rp, int base, unsigned int ui);
  198. extern int rbputl(REC *rp, int base, long l);
  199. extern int rbputul(REC *rp, int base, unsigned long ul);
  200.  
  201. /* source: rcputf.c */
  202. extern int rcputf(REC *rp, size_t begcol, size_t endcol, float f);
  203. extern int rcputd(REC *rp, size_t begcol, size_t endcol, double d);
  204.  
  205. /* source: rcputs.c */
  206. extern int rcputc(REC *rp, size_t col, int ch);
  207. ex